d払い(随時決済) 決済 API一覧
HTTP仕様(.idPass)
HTTP仕様(.json)
Request header |
Content-Type: application/x-www-form-urlencoded;charset=windows-31j |
|
---|---|---|
Method |
POST |
|
Response header |
Content-Type: text/plain;charset=windows-31j |
|
Status Code |
200:常に200を返却 |
Request header |
Content-Type: application/json;charset=UTF-8 |
|
---|---|---|
Method |
POST |
|
Response header |
Content-Type: application/json;charset=UTF-8 |
|
Status Code |
|
・E90010001
・E92000001
・E92000002
・E91099996
・E91099997
EntryTranDocomo 取引登録
これ以降の決済取引で必要となる取引IDと取引パスワードの発行を行い、取引を開始します。
リクエスト
ShopID | shopID | 必須 半角英数13桁
ショップID |
||
---|---|---|---|---|
ShopPass | shopPass | 必須 半角英数64桁
ショップパスワード |
||
OrderID | orderID | 必須 半角英数記号27桁
オーダーID |
||
JobCd | jobCd | 必須
処理区分 AUTH:仮売上 |
||
Amount | amount | 必須 半角数字6桁
利用金額 |
||
Tax | tax | 半角数字6桁
税送料 税送料を指定した場合は、利用金額+税送料が決済金額となります。 |
||
PaymentType | paymentType | 半角数字1桁
決済タイプ 1:随時決済 |
/payment/EntryTranDocomo.json
{
"shopID": "tshop11223344",
"shopPass": "PASSWORD",
"orderID": "ORDER0000001",
"jobCd": "AUTH",
"amount": "1000"
}
/payment/EntryTranDocomo.idPass
ShopID=tshop11223344&ShopPass=PASSWORD&OrderID=ORDER0000001&JobCd=AUTH&Amount=1000
レスポンス
{
"accessID": "a6a6b0061347e90cdef806b39bd28705",
"accessPass": "5e0e54b892e14ed03e8cf807a6053813"
}
AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813
[
{
"errCode":"E01",
"errInfo":"E01040001"
}
]
ErrCode=E01&ErrInfo=E01040001
ExecTranDocomo 決済実行
NTTドコモ社へ決済処理を行い結果を返却します。
リクエスト
ShopID | shopID | 必須 半角英数13桁
ショップID |
||
---|---|---|---|---|
ShopPass | shopPass | 必須 半角英数64桁
ショップパスワード |
||
AccessID | accessID | 必須 半角英数32桁 固定
取引ID |
||
AccessPass | accessPass | 必須 半角英数32桁 固定
取引パスワード |
||
OrderID | orderID | 必須 半角英数記号27桁
オーダーID |
||
ClientField1 | clientField1 | 全半角100バイト
加盟店自由項目1 |
||
ClientField2 | clientField2 | 全半角100バイト
加盟店自由項目2 |
||
ClientField3 | clientField3 | 全半角100バイト
加盟店自由項目3 |
||
DocomoDisp1 | docomoDisp1 | 全半角40バイト
ドコモ表示項目1 |
||
DocomoDisp2 | docomoDisp2 | 全半角40バイト
ドコモ表示項目2 |
||
DispCompanyName | dispCompanyName | 全半角32バイト
会社名 |
||
DispShopName | dispShopName | 全半角32バイト
利用店舗名 |
||
DispPhoneNumber | dispPhoneNumber | 半角数字記号13桁
連絡先電話番号 |
||
DispMailAddress | dispMailAddress | 半角英数記号96桁
メールアドレス |
||
DispShopUrl | dispShopUrl | 半角英数記号96桁
問い合わせURL |
||
DocomoAcceptCode | docomoAcceptCode | 必須 半角数字12桁
ドコモ承諾番号 |
※ 直接契約加盟店様は、DispCompanyName~DispShopUrlの指定は不要です。
※ DispPhoneNumber~DispShopUrlの設定値の合計バイト数を96バイト以内にしてください。
/payment/ExecTranDocomo.json
{
"shopID": "tshop11223344",
"shopPass": "PASSWORD",
"accessID": "a6a6b0061347e90cdef806b39bd28705",
"accessPass": "5e0e54b892e14ed03e8cf807a6053813",
"orderID": "ORDER0000001",
"docomoAcceptCode": "123456789012"
}
/payment/ExecTranDocomo.idPass
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001&DocomoAcceptCode=123456789012
レスポンス
正常
OrderID | orderID | 半角英数記号27桁
オーダーID |
||
---|---|---|---|---|
Status | status |
現状態 該当取引の取引状態を返却します。 |
||
TranDate | tranDate | 半角数字14桁 固定
処理日時 当サービスで処理を実施した日時を返却します。 |
||
DocomoSettlementCode | docomoSettlementCode | 半角数字12桁
ドコモ決済番号 |
||
CheckString | checkString | 半角英数記号32桁
改ざんチェック文字列OrderID,AccessID,ShopID,ShopPassを連結しMD5ハッシュした値を返却します。 |
{
"orderID": "ORDER0000001",
"status": "AUTH",
"tranDate": "20190225162711",
"docomoSettlementCode": "411178431948",
"checkString": "6e72a8518107a9fca81d3afee6972e45"
}
OrderID=ORDER0000001&Status=AUTH&TranDate=20190225162711&DocomoSettlementCode=411178431948&CheckString=6e72a8518107a9fca81d3afee6972e45
[
{
"errCode":"E01",
"errInfo":"E01040001"
}
]
ErrCode=E01&ErrInfo=E01040001
DocomoCancelReturn 決済キャンセル・返品
決済が完了した取引に対して決済内容のキャンセル・返品を行います。
リクエスト
ShopID | shopID | 必須 半角英数13桁
ショップID |
||
---|---|---|---|---|
ShopPass | shopPass | 必須 半角英数64桁
ショップパスワード |
||
AccessID | accessID | 必須 半角英数32桁 固定
取引ID |
||
AccessPass | accessPass | 必須 半角英数32桁 固定
取引パスワード |
||
OrderID | orderID | 必須 半角英数記号27桁
オーダーID |
||
CancelAmount | cancelAmount | 必須 半角数字6桁
キャンセル金額 |
||
CancelTax | cancelTax | 半角数字6桁
キャンセル税送料キャンセル金額+キャンセル税送料をキャンセル金額とします。(1円以上) |
/payment/DocomoCancelReturn.json
{
"shopID": "tshop11223344",
"shopPass": "PASSWORD",
"accessID": "a6a6b0061347e90cdef806b39bd28705",
"accessPass": "5e0e54b892e14ed03e8cf807a6053813",
"orderID": "ORDER0000001",
"cancelAmount": "100"
}
/payment/DocomoCancelReturn.idPass
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001&CancelAmount=100
レスポンス
正常
OrderID | orderID | 半角英数記号27桁
オーダーID |
||
---|---|---|---|---|
Status | status |
現状態 キャンセル・返品成功時は以下のステータスが返却されます。 |
||
Amount | amount | 半角数字6桁
利用金額 利用金額からキャンセル金額を減算した結果を返却します。 |
||
Tax | tax | 半角数字6桁
税送料 税送料からキャンセル税送料を減算した結果を返却します。 |
||
CancelAmount | cancelAmount | 半角数字6桁
キャンセル金額キャンセル金額を返却します。 |
||
CancelTax | cancelTax | 半角数字6桁
キャンセル税送料キャンセル税送料を返却します。 |
{
"orderID": "ORDER0000001",
"status": "CANCEL",
"amount": "0",
"tax": "0",
"cancelAmount": "100",
"cancelTax": "0"
}
OrderID=ORDER0000001&Status=CANCEL&Amount=0&Tax=0&CancelAmount=100&CancelTax=0
[
{
"errCode":"E01",
"errInfo":"E01040001"
}
]
ErrCode=E01&ErrInfo=E01040001
DocomoSales 実売上
仮売上の決済に対して実売上を行います。尚、実行時に仮売上時との金額チェックを行います。
リクエスト
ShopID | shopID | 必須 半角数字13桁
ショップID |
||
---|---|---|---|---|
ShopPass | shopPass | 必須 半角英数64桁
ショップパスワード |
||
AccessID | accessID | 必須 半角英数32桁 固定
取引ID |
||
AccessPass | accessPass | 必須 半角英数32桁 固定
取引パスワード |
||
OrderID | orderID | 必須 半角英数記号27桁
オーダーID |
||
Amount | amount | 必須 半角数字6桁
利用金額 |
||
Tax | tax | 半角数字6桁
税送料利用金額+税送料が売上金額となります(1円以上) |
/payment/DocomoSales.json
{
"shopID": "tshop11223344",
"shopPass": "PASSWORD",
"accessID": "a6a6b0061347e90cdef806b39bd28705",
"accessPass": "5e0e54b892e14ed03e8cf807a6053813",
"orderID": "ORDER0000001",
"amount": "100"
}
/payment/DocomoSales.idPass
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001&Amount=100
レスポンス
{
"orderID": "ORDER0000001",
"status": "SALES",
"amount": "100",
"tax": "0"
}
OrderID=ORDER0000001&Status=SALES&Amount=100&Tax=0
[
{
"errCode":"E01",
"errInfo":"E01040001"
}
]
ErrCode=E01&ErrInfo=E01040001
DocomoIncrease 増額
決済が完了した取引に対して決済内容の増額を行います。
リクエスト
ShopID | shopID | 必須 半角英数13桁
ショップID |
||
---|---|---|---|---|
ShopPass | shopPass | 必須 半角英数64桁
ショップパスワード |
||
AccessID | accessID | 必須 半角英数32桁 固定
取引ID |
||
AccessPass | accessPass | 必須 半角英数32桁 固定
取引パスワード |
||
OrderID | orderID | 必須 半角英数記号27桁
オーダーID |
||
IncreaseAmount | increaseAmount | 必須 半角数字6桁
増加金額 |
||
IncreaseTax | increaseTax | 半角数字6桁
増加税送料増加金額+増加税送料を増加金額とします。(1円以上) |
/payment/DocomoIncrease.json
{
"shopID": "tshop11223344",
"shopPass": "PASSWORD",
"accessID": "a6a6b0061347e90cdef806b39bd28705",
"accessPass": "5e0e54b892e14ed03e8cf807a6053813",
"orderID": "ORDER0000001",
"increaseAmount": "100"
}
/payment/DocomoIncrease.idPass
ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&OrderID=ORDER0000001&IncreaseAmount=100
レスポンス
正常
OrderID | orderID | 半角数字記号27桁
オーダーID |
||
---|---|---|---|---|
Status | status |
現状態増額成功時は以下のステータスが返却されます。 |
||
Amount | amount | 半角数字6桁
利用金額利用金額から増加金額を加算した結果を返却します。 |
||
Tax | tax | 半角数字6桁
税送料税送料から増加税送料を加算した結果を返却します。 |
||
IncreaseAmount | increaseAmount | 半角数字6桁
増加金額増加金額を返却します。 |
||
IncreaseTax | increaseTax | 半角数字6桁
増加税送料増加税送料を返却します。 |
{
"orderID": "ORDER0000001",
"status": "SALES",
"amount": "200",
"tax": "0",
"increaseAmount": "100",
"increaseTax": "0"
}
OrderID=ORDER0000001&Status=SALES&Amount=200&Tax=0&IncreaseAmount=100&IncreaseTax=0
[
{
"errCode":"E01",
"errInfo":"E01040001"
}
]
ErrCode=E01&ErrInfo=E01040001